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Introduction 



In March 2012, a decision was taken to move the development of 
Csound from version 5 to a new major version, 6. 


Moving to a n v version allowed developers to 
the syste , iout qu keeping ABI or 

oompatibii.iy with earli^. itera+'u.io. 

The only restriction, which is a fundamental one for Csound, is to 
provide backwards language compatibility, ensuring that music 
composed with the software will continue to be preserved. 
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Background 


A Short History of Csound 


Csound can be traced back to Barry Vercoe’s MUSIC 360 package for 
computer music (1968), which was itself a variant of Max Mathews’ 
and Joan Miller’s MUSIC IV (1964). 


Later, witn the avaiiacility or u (and Uinia), mis pn :; re i 

in that language as Csound, allowing a simpler cycle of developr i mt 
and portab lity, in comparison to its predecessor. In the early 2000s, 
the final releases of version 4 attempted to retrofit an application 
programming interface (API), so that the system could be used as a 
library. 
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A Short History of Csound 


Csound can be traced back to Barry Vercoe’s MUSIC 360 package for 
computer music (1968), which was itself a variant of Max Mathews’ 
and Joan Miller’s MUSIC IV (1964). 

Following the introduction of the PDP-11 minicomputer, a modified 
version of the software appeared as MUSIC 11. 

Later, with the availability of C (and UNIX), this program was re-written 
in that language as Csound, allowing a simpler cycle of development 
and portability, in comparison to its predecessor. In the early 2000s, 
the final releases of version 4 attempted to retrofit an application 
programming interface (API), so that the system could be used as a 
library. 
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Csound 5 



The need for the further development of the Csound API, as well as 
other innovations, prompted a code freeze and a complete overhaul of 
the system into version 5, released as a library with a few basic 
frontends, in 2006. 

Much of this development included updating 1970s programming 
practices by applying more modern standards. One of the major aims 
was to make the code reentrant, so that its use as a library col Id be 
made more robust. 
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Csound operation in a nutshell 


As a MUSIC-N language, Csound incorporates a compiler for 
instruments. During performance, these can be activated (instantiated) 
by various means, the traditional one being the standard numeric 
score. 


At irisic‘i! lion, an init-pass loop is performed, executing all tne 
once-off operations for that instance. This is then inserted in a list of 
active instruments, and its performance code is executed sequentially, 
processing vectors (audio signals), scalars (control signals) or frames 
of spectral data. 


Csound 6 




5/23 


ffitch, Lazzarini and Yi (NUIM) 


LAC2013 






Background 


Csound operation in a nutshell 


As a MUSIC-N language, Csound incorporates a compiler for 
instruments. During performance, these can be activated (instantiated) 
by various means, the traditional one being the standard numeric 
score. 

The steps involved in the compiler can be divided into two: parsing, 
and compilation proper. 

At instantiation, an init-pass loop is performed, executing all the 
once-off operations for that instance. This is then inserted 'n a list of 
active instruments, and its performance code is executed sequentially, 
processing vectors (audio signals), scalars (control signals) or frames 
of spectral data. 


► ■« gi ► 


ffitch, Lazzarini and Yi (NUIM) 

Csound 6 


Background 



LAC2013 5/23 


Csound operation in a nutshell 


As a MUSIC-N language, Csound incorporates a compiler for 
instruments. During performance, these can be activated (instantiated) 
by various means, the traditional one being the standard numeric 
score. 

The steps involved in the compiler can be divided into two: parsing, 
and compilation proper. 

At instantiation, an init-pass loop is performed, executing all the 
once-off operations for that instance. This is then inserted in a list of 
active instruments, and its performance code is executed sequentially, 
processing vectors (audio signals), scalars (control signals) or frames 
of spectral data. 


Csound 6 




<\(y 

5/23 


ffitch, Lazzarini and Yi (NUIM) 


LAC2013 






Csound6 


Motivation 


Following the 2011 Csound Conference in Hannover, there were a 
number of user requests that would be more easily achievable with a 
version bump: 
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o r r v ion of the API to allow further fe; jre in frontends 
o loadable Dinary formats, API construction of instruments 
a further development of parallelism 
9 improved facilities for live coding 
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Developments to date: Build system and Tests 


In Csound 6, the official build system is now the CMake-based build. 
Moving to CMake introduced some hurdles and changes in workflow, 
but it also brought with it generation of build system files, such as 
Makefiles, XCode projects, and Eclipse projects. 


J LU 

i ' [I employed to v v v lv r 

- ^ .:,„jtes \..:hin the test code files. Beyond C-code testing, the 
oT CSD's used for application/integration testing continues to grow, and 
a new set of Python tests has also been added for testing API usage 
from a host language. 
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In Csound 6, the official build system is now the CMake-based build. 
Moving to CMake introduced some hurdles and changes in workflow, 
but it also brought with it generation of build system files, such as 
Makefiles, XCode projects, and Eclipse projects. 

Unit and functional tests have been added to Csound 6’s codebase. 
CTest is the test running utility used to execute the individual C-code 
tests. In addition, CUnit is employed to create the individual tests and 
test-suites within the test code files. Beyond C-code testing, the suite 
of CSD’s used for application/integration testing continues to grow, and 
a new set of Python tests has also been added for testing API usage 
from a host language. 
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Developments to date: Code Reorganisation 


The Csound code base is passing through a significant reorganisation: 
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The Csound code base is passing through a significant reorganisation: 

a obsolete code, such as the old parser, has been removed. 

9 some opcodes have been completely rewritten 
9 The CSOUND struct has been rationalised and reorganised 
9 the public API has been redesigned 


Csound 6 




8/23 


ffitch, Lazzarini and Yi (NUIM) 


LAC2013 





Csound6 


Developments to date: Type System 


The Csound language uses strongly typed variables and enforces 
these at compile-time. The system of types was hard-coded into the 
parser and compiler. 


Variable definitions and types are kept after compilation. This allows 
the possibility of inspecting variables found in instruments or in the 
global memory space. 
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Developments to date: Generic Arrays 



In Csound 5, a ‘f type was added that provided a user-definable 
length, single-dimension array of floating-point numbers. 

In Cs 
for t-type; 
multi-dim^, .o, 
specification 1 
arguments. 
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Developments to date: Generic Arrays 


In Csound 5, a ‘f type was added that provided a user-definable 
length, single-dimension array of floating-point numbers. 

In Csound 6, with the introduction of the generic type system, the code 
for t-types was extended to allow creation of homogenous, 
multi-dimensional arrays of any type. Additionally, the argument list 
specification for opcodes was extended to allow denoting arrays as 
arguments. 
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Developments to date: On-the-fly Compilation 


The first steps necessary for on-the-fly compilation, were in the latter 
versions of Csound 5, with the introduction of the new parser. Also, 
compilation from text files was replaced by a new core (memory) file 
subsystem, so now strings containing Csound code could be 
presented directly to the parser. 

In Csound 6, the monolithic API call to conipile/start Csound is broken 
down into cs o u]-id P as e0 .i:c () + csoundC o mp i. 1 eTr ee () (with 
these two combined in csoundCompiieOrc ()) and 
csounadtart (). The parsing function creates an abstract syntax 
tree (AST) from a string containing Csound code. The compilation 
function then creates the internal data structures that the AST 
represents, ready for engine instantiation. These operations can be 
performed repeatedly. 
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In Csound 6, the monolithic API call to compile/start Csound is broken 
down into csoundParseOrc () + csoundCompileTree () (with 
these two combined in csoundCompiieOrc ()) and 
csoundstart (). The parsing function creates an abstract syntax 
tree (AST) from a string containing Csound code. The compilation 
function then creates the internal data structures that the AST 
represents, ready for engine instantiation. These operations can be 
performed repeatedly. 
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Developments to date: On-the-fly Compilation 


'Merge 
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Csound 


EngincSuitc 


•VAR.POOL (Globals) 
-Opcode List 
-INSTR List 
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Developments to date: Sample Accuracy 



Csound has always allowed sample-level accuracy, a feature present 
since its MUSIC 11 incarnation, by setting the processing block, 
(ksmps), to 1 sample. 

Ini a 6, an alte lative sample accuracy method has been 
inti educed, using an offset into the processing block, which will round 
the start tirriw of an event to a single sample. Similarly, event durations 
are also made to be sample accurate, as the last iteration of each 
processing loop is limited to the correct number of samples. 
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since its MUSIC 11 incarnation, by setting the processing block, 
(ksmps), to 1 sample. 

In Csound 6, an alternative sample accuracy method has been 
introduced, using an offset into the processing block, which will round 
the start time of an event to a single sample. Similarly, event durations 
are also made to be sample accurate, as the last iteration of each 
processing loop is limited to the correct number of samples. 
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Developments to date: Sample Accuracy 



Early end 


Cycle 1 


Cycle 2 


Cycle 3 


Cycle n 


silent 


silent 


This option is provided with the non-default — sample-accurate 
flag, to preserve backward compatibility. 
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Developments to date: Realtime Priority Mode 



Csound has been a realtime audio synthesis engine since 1990, 
although it was never provided with strict realtime-safe behaviour. 

Given the n 
separate opei 

realtime priority I I LIIV2 I I , VVIIIOIIC4III 

provide better support re realtimo wuiety, with c:. 'lete asynchrr 
file access and a separate thread for unit generator initialisation. 
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Developments to date: Realtime Priority Mode 



Csound has been a realtime audio synthesis engine since 1990, 
although it was never provided with strict realtime-safe behaviour. 

Given the multiple applications of Csound, it makes sense to provide 
separate operation modes for its engine. In Csound 6, we introduce the 
realtime priority mode, set by the — realtime option, which aims to 
provide better support for realtime safety, with complete asynchronous 
file access and a separate thread for unit generator initialisation. 
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Developments to date: Multicore Operation 



In 2009 an experimental system for using multiple cores for parallel 
rendering of instruments was written, and later incorporated in Csound 
5. While the design was generally semantically correct it only delivered 
moderate performance gains. 

For Csound 6 we are developing a different appro ;h, where semantic 
analysis and the creation/consumption of the DAG of dependencies is 
only done on instantiation/destruction of 'nstruments. This uses 
watch-lists as found in SAT-solvers. 
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Developments to date: Multicore Operation, 
preliminary results 


-j 

CloudStrata 

ksmps=500 (sr=96000) 

Xanadu 

ksmps=10 

ksmps=100 

Trapped... 

ksmps=10 

ksmps=100 

ksmps=1000 

1 

1 

1 

1 

1 

1 

1 

2 

0.54 

0.57 

0.55 

0.75 

0.79 

0.78 

3 

0.39 

0.40 

0.40 

0.66 

0.76 

0.73 

4 

0.32 

0.39 

0.33 

0.61 

0.72 

0.70 


Relative performance with multiple threads in three existing Csound 
code examples, -j indicates the number of threads used 
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Other developments 


Since the time of the writing of this paper, other developments have 
taken place: 


out linen(moogladder(vco2(p4,p5), 

1000+linen(2000,0.5,p3,0.5),0.7), 

1,p3,.1) 
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Other developments 


Since the time of the writing of this paper, other developments have 
taken place: 

o Reordering of compilation stages and overhaul of the semantic 
system. 


★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■sir******* 
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Since the time of the writing of this paper, other developments have 
taken place: 

o Reordering of compilation stages and overhaul of the semantic 
system. 

o support for functions with more than one arguments and opcodes 
as functions (that can be inlined in expressions) was added. 

out linen(moogladder(vco2(p4,p5), 

1000+linen(2000,0.5,p3,0.5),0.7), 
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Other developments 


9 the 6.00 API has been finalised 


9 further internal changes (local ksmps in instrs, hash tables for 
strings, more code reorganisation, etc) 

9 Csound 6 Release Candidate 1 has been finalised, RC2 on its 
way. 
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o multiple strings in event parameters are now allowed 
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Conclusions 


Future developments 


A number of ideas have also been put forward, which will be tackled in 
due course. These include for instance: 


■ p- I 1^' I i.i .1 I I -■ I I . I . I I ' ^ * I \ - I i.i -■ .■ I - I . 

SD ing, dynamic typing) 

o decoupling of widget opcodes from FLTK dependency (and 
exposure through API) 

c input / output buffer reorganisation (output buffers added to 
instruments) 
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Conclusions 


We hope to have demonstrated how the technology embodied in this 
software package has been renovated continuously in response to 
developments in Computer Science and Music. Our aim is to continue 
to support a variety of styles of computer music composition and 
performance, as well as the various ways in which Csound can be 
used for application development. 

It is also important to note, for readers, that the re-engineering of 
Csound is taking place quite publicly in the Csound 6 git repository on 
Sourceforge 

(git: //git. code . sf . net/p/csound/csound6-git). Anyone is 
welcome to check out and examine our struggles with computer 
technology and the solutions we are putting forward here. 
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